home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 112 / EnigmaAmiga112CD.iso / dalla rivista / workbench / freedom / docs / install truetype font < prev    next >
Text File  |  1998-07-16  |  5KB  |  130 lines
  1. This script allows you to install one or more TrueType fonts.
  2.  
  3. Installing an outline font to be used by a standard OS font engine (such
  4. as bullet.library for Compugraphic Fonts and freedom.library for TrueType
  5. fonts) means doing the following things (the script will do it for you):
  6.  
  7.   o Create "<fontname>.font" in FONTS: This 4 byte long file gets a special
  8.     ID telling the OS that this is not a standard Amiga bitmap font but one
  9.     to be used with a font engine (library). Information on what engine has
  10.     to be used with this font and more can be retrieved from the ".otag"
  11.     file:
  12.  
  13.   o Create "<fontname>.otag" in FONTS: This file contains a lot of info
  14.     about the outline font, most importantly which engine (library) to
  15.     use with it. Among that most of the stuff in the .otag file is only
  16.     needed by diskfont.library.
  17.  
  18.   o Copy the real font file (in the case of TrueType fonts the ".ttf" or
  19.     ".ttc" file) to any place. This depends on the font engine. Usually
  20.     the .otag file created by the Font Manager or Font Installation script
  21.     (in the case of Freedom) saves the full path of the font in the otag
  22.     file.
  23.  
  24.  
  25. This installation script is actually not clever enough to find out all
  26. information itself. Therefore you will be prompted for the missing things.
  27. If you don't know what to enter, accept what you get as default in the
  28. string gadget.
  29.  
  30.  
  31. You will be asked for:
  32.  
  33. o YSizeFactor High and YSizeFactor Low:
  34.  
  35.   This two form a ratio (YSizeFactor High/YSizeFactor Low) telling
  36.   diskfont.library (I think) how to "convert Amiga pixel height specifica-
  37.   tion, which describes the distance from the lowest descender to the
  38.   highest ascender, into a point size specification, which is related 
  39.   (via YSizeFactor) to a nominal character height"
  40.   
  41.   As far as I have understood it this should be something like this:
  42.   
  43.   ************************ -------+
  44.   *                      *        |
  45.   *  oooooo ------------ * ------ | -----+
  46.   *    oo                *        |      |
  47.   *    oo      ooooo     *        |      |
  48.   *    oo     oo  oo     *       "A"    "B"
  49.   *    oo      ooooo     *        |      |
  50.   *                o     *        |      |
  51.   *            o   o     *        |      |
  52.   *             ooo  --- * ------ | -----+
  53.   *                      *        |
  54.   ************************ -------+
  55.  
  56.   So the ratio would be B / A. For example if B = 6 and A = 10 then we could
  57.   use one of the following values for YSizeFactorHigh and YSizeFactor low
  58.   (all with the same result, only the ratio counts):
  59.  
  60.                           High:     6  Low: 10
  61.                           High:    12  Low: 24
  62.                           High: 12000  Low: 20000
  63.  
  64.   Both values must match into 16 Bit so don't use values bigger than 32767!!
  65.  
  66.   I have tried to look at some fonts to find out what "B" (lowest descender
  67.   to highest ascender) they have and I noticed in some of them "B" is higher
  68.   than "A". I have not tried out if it's OK for diskfont.library (and other
  69.   programs?) to have such a ratio (> 1.0) therefore actually you are asked
  70.   to enter this values manually. For now I suggest you to either accept the
  71.   default values (High=8782 and Low=10034 --> ratio = 0.875224) or to set
  72.   both High and Low to the same value. How good it looks will depend on the
  73.   font also (I guess).
  74.  
  75.  
  76. o SpaceWidth:
  77.  
  78.   Width of the space character in fraction of an EM . Probably used by disk-
  79.   font.library only. Don't know much more. Accept the default value for now.
  80.  
  81.  
  82. o Sizes to be displayed in ASL requesters:
  83.  
  84.   Nothing to explain apart from the fact, that this are *not* the only sizes
  85.   you will be able to use with diskfont.library - these should be the usual
  86.   sizes you are going to use with this font. You will be able to use the
  87.   font at any size by typing in the desired size manually in ASL requesters.
  88.  
  89.  
  90. o Whether the font to be installed has serifs or not:
  91.  
  92.   There *is* some information about that in the truetype file, but it's
  93.   not defined as BOOL (YES or NO), instead it is a value which defines
  94.   the "grade of serif-ness". I know what each possible value means in
  95.   words - I have the truetype specification - but I don't know where to
  96.   put the "step from IS_SERIF to IS_NOT_SERIF".
  97.  
  98.   
  99.  
  100. To speed up installation of fonts, it's possible to define standard
  101. values (you won't be asked by the script anymore) for:
  102.  
  103.   YSizeFactorHigh
  104.   YSizeFactorLow
  105.   SpaceWidth
  106.   AvailSizes
  107.  
  108. All you have to do is set the relative tooltypes in the script's icon.
  109. For example:
  110.  
  111.    YSIZEFACTORHIGH=10000
  112.    YSIZEFACTORLOW=10000
  113.    SPACEWIDTH=0.88
  114.    AVAILSIZES=10 20 30 40 50 60
  115.  
  116.  
  117. Final Notes:
  118. ============
  119.  
  120. o The script is not yet able to detect a reverse italic font.
  121.  
  122. o You can install fonts by hand (= Shell) by using the utilities in the
  123.   "Tools" directory. See "Tools" doc.
  124.  
  125. o If the font character spacing is wrong (the glyphs (= letters) overlap)
  126.   when using a font with diskfont.library re-install the font and change
  127.   SpaceWidth!
  128.  
  129.  
  130.